home *** CD-ROM | disk | FTP | other *** search
/ PC Treasures, Inc. / pctreasures.mdf / EUDORA / Eudora43 Installer Customization.txt < prev    next >
Text File  |  2000-03-08  |  10KB  |  215 lines
  1. EUDORA 4.3 INSTALLER CUSTOMIZATION GUIDE
  2. 02/17/00
  3.  
  4.  
  5. The Eudora installer uses an initialization file (Instopt.ini) for 
  6. customization purposes.  Instopt.ini contains four sections, each of
  7. which is explained below.  This file must be located in the same
  8. directory as the rest of the setup files.  If this file is not
  9. included with the rest of the Eudora setup files, strange and
  10. undesirable behavior of the installer is guaranteed.
  11.  
  12.  
  13. The [General] Section
  14. ---------------------
  15. This section has two keys:
  16. APP_NAME ----- This is the name of the application.  This value is
  17.                used throughout the installer to give titles to some
  18.                windows and such.
  19. APP_VERSION -- This is the version number of the application.
  20.  
  21. None of the keys or values in this section should be changed.
  22.  
  23.  
  24. The [User_Info] Section
  25. -----------------------
  26. This section contains information about custom files the user may want
  27. to add (and how those files are to be handled by the installer), a
  28. setting for creating/naming an icon on the desktop during install, a
  29. setting for prompting for an alternate mail box location (with an
  30. option to set that dialog's text message), and settings that allow one
  31. to alter the Eudora.ini file during install.
  32.  
  33. To add a custom file to the installer, simply put it in the directory
  34. where the rest of the installer files live and edit the appropriate
  35. USER_FILE line(s).  A line with no value is ignored.
  36.  
  37. USER_FILE_MODE determines how the custom files are copied to the
  38. installation directory:
  39. AlwaysOverwrite - USER_FILE will always be copied to install directory
  40. NeverOverwrite -- USER_FILE will not be copied to the install
  41.                   directory if same named file is found
  42. OverwriteNewer -- USER_FILE will only be copied if newer than same
  43.                   named file in install directory
  44.  
  45. All three user files have the same mode.  The values for these options
  46. are case sensitive.  Note that Ph.ini, Finger.ini and LDAPinit.ini are
  47. already included in the setup as uncompressed files, and need not be
  48. specified here.
  49.  
  50.   TIP: You can put default Eudora settings in a user file called
  51.   DEudora.ini (for example, USER_FILE1=DEudora.ini). When a setting
  52.   isn't found in Eudora.ini, Eudora will look in the DEudora.ini file
  53.   located in the same directory as Eudora.exe. The Eudora installer
  54.   won't replace an existing Eudora.ini, which means users won't lose
  55.   changes they've made to their settings. The Eudora installer will
  56.   install the new DEudora.ini (assuming you set USER_FILE_MODE to
  57.   AlwaysOverwrite), which ensures that the right defaults will be used
  58.   for settings the user hasn't changed.
  59.  
  60.   If you elect to use DEudora.ini, you should still put your desired
  61.   settings in Eudora.ini as well. It will always be copied on a fresh
  62.   install.
  63.  
  64.   Deudora.ini is a special file that is used in conjunction with 
  65.   Eudora.ini.  Eudora runs as if each section of Deudora.ini is added
  66.   to the corresponding section of Eudora.ini.  If there is a
  67.   conflicting setting, then Eudora.ini takes precedence.  
  68.  
  69. The SUPPRESS_REGISTRY_WARNINGS key, when set to 1, will suppress the
  70. displaying of most of the warnings resulting from not being able to
  71. write to the registry due to lack of administrator privileges on
  72. Windows NT. These messages will be displayed as appropriate if this
  73. key is set to 0.
  74.  
  75. The CREATE_SHORTCUT key has two possible values, 0 and 1. When set to
  76. 0, the installation routine does not ask about placing a shortcut on
  77. the desktop. When set to 1, this dialog is presented during
  78. installation.
  79.  
  80. The shortcut is titled using the ICON_SHORTCUT_NAME value.  Note that
  81. if this value is different from the name of a previous shortcut, an
  82. additional shortcut is created.  If this value is the same as the
  83. original shortcut name, the target for that shortcut is overwritten.
  84. If no value is given, "Eudora" is used.
  85.  
  86. The MAIL_DIRECTORY_PATH key is an optional directory path that gets
  87. appended to the Eudora shortcuts (Start menu and desktop, if chosen)
  88. made by the installer. This extra path info is passed as a command
  89. line argument to Eudora, and the user's mailboxes will be stored,
  90. created, etc. in that location.  This option might be used, for
  91. example, when you wish to keep a user's mailboxes on a network drive
  92. or a separate folder on a local drive.
  93.  
  94. If you want to keep a user's mail folder in a different location,
  95. enter that path here and the user will either be forced to accept that
  96. path, or will be prompted to browse for another folder with that
  97. folder as the default (see MAIL_DIRECTORY_PROMPT below).  Paths should
  98. be of the form:
  99.     <drive letter>:\<path>   (Example: h:\mailboxes\jsmith)
  100. Do not use a trailing slash on pathnames.  If the path cannot be
  101. found, the default Eudora mail directory is used.
  102.  
  103. Leave this value blank if you don't wish to use alternate mailbox
  104. folders.
  105.  
  106. If the MAIL_DIRECTORY_PATH key is set, the MAIL_DIRECTORY_PROMPT key
  107. determines whether or not the user is prompted. If this is set to 1,
  108. then the user will be prompted to either accept the path specified in
  109. MAIL_DIRECTORY_PATH or browse for another folder. If this is set to 0,
  110. then the user will be forced to accept the alternate location (and
  111. will not be prompted). This might be handy when you know that every
  112. user's mail should always reside in one location (such as a shared
  113. network drive) and you do not wish the user to be able to change it.
  114. Note that if this value is set to 0 and the specified
  115. MAIL_DIRECTORY_PATH does not exist and cannot be created (for whatever
  116. reason), Eudora will revert to the original, default mailbox folder,
  117. and no alternate mailbox folder will be used.
  118.  
  119. If MAIL_DIRECTORY_PROMPT is set to 1, the MAIL_DIRECTORY_DIALOG_TEXT
  120. key is the dialog text that appears when a user is prompted for an
  121. alternate mailbox directory location. This text should be at most
  122. 256 characters, not containing any words over 50 characters long, and 
  123. should be all on one line (it will be sized automatically by the 
  124. installer). If left blank, a generic message is used.  
  125.  
  126. Set UPDATE_EUDORA_INI to 1 to add, modify or remove Eudora.ini file
  127. settings at install time.  The user's old Eudora.ini file is renamed
  128. to Eudora_ini.old before any changes are made.
  129.  
  130. You must specify a section name using the UPDATE_SECTION key.  The
  131. default value for this is "Settings", as this is where most of
  132. Eudora's customization should be placed.  DO NOT use brackets ([])
  133. when specifying a section name, or settings will not be written to the
  134. ini file.  If an UPDATE_SECTION value has not been specified, no
  135. name/value information will be written to Eudora.ini.
  136.  
  137. Specify a series of key name and value pairs using KEY_XXX_NAME/
  138. KEY_XXX_VALUE. If a key name is specified, a key value must also be
  139. specified.  If UPDATE_EUDORA_INI is set to zero and name/value pairs
  140. have been specified here, they will not be written to the Eudora.ini
  141. file.  
  142.  
  143. Note that you should make these same name/value additions to the
  144. default  Eudora.ini that comes with the installer (it's uncompressed
  145. and with the rest of the installer files).  This file is used during
  146. an install when no Eudora.ini can be found.  When this file is used
  147. during an install, none of these settings will be written. 
  148.  
  149.  
  150. The [Included] Section
  151. ----------------------
  152. This section contains all the third-party software that normally
  153. comes with Eudora. The keys here allow one to suppress or display
  154. installation information about these applications (which is useful if
  155. these installer(s) are not going to be included with the Eudora
  156. installer).
  157.  
  158. When the installation is complete, a final window is displayed. To
  159. edit the text at the top of the window, set THIRD_PARTY_DIALOG_HEADER
  160. to the desired message. If left blank, a generic message is displayed.
  161. To edit the text at the bottom of the window, set
  162. THIRD_PARTY_DIALOG_FOOTER to the desired message. If left blank, it
  163. will similarly display a generic message. Each of these messages
  164. should be kept under 256 characters, should not use any words over 50
  165. characters long, and should all be on one line (they will be sized
  166. automatically by the installer).
  167.  
  168. If DEFAULT_URL is set to 1, the window will give the user an option to
  169. go to Eudora's software download page, which will automatically detect
  170. which third party software the user is missing. If, however, you would
  171. prefer to use your own custom URL, set DEFAULT_URL to 0, and set
  172. CUSTOM_URL to the full URL name. If it is local, include the prefix
  173. "file://", otherwise include "http://". If no page is to be opened,
  174. set DEFAULT_URL to 0 and do net set the values of CUSTOM_URL.
  175.  
  176. If you would rather open a folder containing icons of the applications
  177. to be optionally installed, set CUSTOM_FOLDER to the full path name of
  178. the directory which contains these files. This will only be opened if
  179. no web page is opened, and will be ignored if not set.
  180.  
  181. Note that if none of the above options are set (ie. DEFAULT_URL=0, and
  182. CUSTOM_URL and CUSTOM_FOLDER are not set, then the checkbox on the
  183. window to install software disappears.
  184.  
  185. Set INSTALL_PUREVOICE to 1 if you would like include an option that
  186. allows PureVoice to be installed directly from this installer. Set to
  187. 0 to disable this option.
  188.  
  189.  
  190. The [Type] Section
  191. ------------------
  192. These are the types of installations possible with a "regular" Eudora
  193. installer:
  194.  
  195. ELECTRONIC=1
  196. CD_INSTALL=0
  197. FULL_UPGRADE=0
  198. BETA=0
  199. DEMO=0
  200.  
  201. The only option that should be set for these purposes is ELECTRONIC.
  202. The other options depend on files and routines that may not be
  203. present. If more than one option is set to 1, the first option read
  204. from the ini file will be used.  If none of the options is set, 
  205. undesirable results are likely.
  206.  
  207. If you wish to distribute this installer on a CD, yet you wish to
  208. distribute MSIE or QuickTime, leave ELECTRONIC set to 1.  Simply
  209. specify a path name (in the [Included] section) for the directory
  210. that contains these installers, then include them with the rest of
  211. the Eudora setup files on the disc.
  212.  
  213. Note that there is currently no way to specify a subdirectory of the
  214. Eudora install directory for these installers.  Because of
  215. InstallShield limitations, this will likely never be implemented.